home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 008 / ddl100c.arj / DDLSYSOP.DOC < prev    next >
Text File  |  1995-01-31  |  16KB  |  354 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                 Domain DataLink
  21.  
  22.                     Copyright (c) 1995 Domain Entertainment
  23.  
  24.                            Installation/Configuration
  25.  
  26.                              Last Updated 01/31/95
  27.  
  28. Domain DataLink                                               Table of Contents
  29. ───────────────────────────────────────────────────────────────────────────────
  30.  
  31. Program Description/Features ............................................... 1
  32.  
  33. Quick & Easy Synchronet Setup .............................................. 2
  34.  
  35. Quick & Easy RBBS Setup .................................................... 3
  36.  
  37. Quick & Easy Wildcat! Setup ................................................ 4
  38.  
  39. Quick & Easy Generic BBS Setup ............................................. 5
  40.  
  41. Command Line Options ....................................................... 6
  42.  
  43. Questions & Answers ........................................................ 8
  44.  
  45. Problems & Solutions ....................................................... 9
  46.  
  47. Exit Codes ................................................................. 10
  48.  
  49. Demo Limitations ........................................................... 11
  50.  
  51. Domain DataLink               Description/Features                       Page 1
  52. ───────────────────────────────────────────────────────────────────────────────
  53.  
  54.     Domain DataLink is a program that, through your BBS, will allow users to
  55. connect to each other - just as though one had called the other directly!  Any
  56. functions which could normally be performed by a user directly calling another
  57. user via their modem can also be accomplished using the Domain DataLink.  This
  58. includes (but is by no means limited to) playing modem capable games (e.g.
  59. DOOM, DOOM ][, Falcon, etc.) and transferring files directly to each other.
  60.     Domain DataLink has the capability to work with ANY BBS software, but has
  61. certain additional functions which are usable only when running under
  62. Synchronet BBS software (e.g. sending and receiving messages from the BBS).
  63.     Following is a quick and easy set up for Synchronet BBS software, as well
  64. as a list of available command line options, and suggestions for running under
  65. other BBS packages (if anyone running any of these packages has more info on
  66. setting up under them, please contact Domain Entertainment with that info).
  67.  
  68. Domain DataLink          Quick & Easy Synchronet Setup                   Page 2
  69. ───────────────────────────────────────────────────────────────────────────────
  70.  
  71.     If you received Domain DataLink on a floppy diskette, simply insert the
  72. diskette into the floppy drive.  Log into that drive and run the INSTALL
  73. program.
  74.  
  75.     If you downloaded Domain DataLink (or received it in the form of a ZIP
  76. compressed file) then you must create the directory DATALINK within your
  77. \SBBS\XTRN directory (to make \SBBS\XTRN\DATALINK).  Once the directory has
  78. been created, simply unzip the compressed file into that directory.
  79.  
  80.     Now you'll need to run your SCFG program.  Create a NEW external program
  81. and set it up as follows:
  82.  
  83.           ╔══════════════════════════════════════════════════════════╗
  84.           ║                      Domain DataLink                     ║
  85.           ╠══════════════════════════════════════════════════════════╣
  86.           ║ │Name                       Domain DataLink              ║
  87.           ║ │Internal Code              DATALINK                     ║
  88.           ║ │Start-up Directory         ..\XTRN\DATALINK             ║
  89.           ║ │Command Line               DDL D:%d                     ║
  90.           ║ │Clean-up Command Line                                   ║
  91.           ║ │Cost in Credits            0                            ║
  92.           ║ │Access Requirements                                     ║
  93.           ║ │Execution Requirements                                  ║
  94.           ║ │Multiple Concurrent Users  Yes                          ║
  95.           ║ │Intercept I/O Interrupts   No                           ║
  96.           ║ │Swap BBS out of Memory     Yes                          ║
  97.           ║ │Modify User Data           No                           ║
  98.           ║ │Execute on Event           No                           ║
  99.           ║ │BBS Drop File Type         Synchronet      XTRN.DAT     ║
  100.           ║ │Place Drop File In         Node Directory               ║
  101.           ╚══════════════════════════════════════════════════════════╝
  102.  
  103.     That's it!  It's installed and ready to go!  The only option you may wish
  104. to add is the 'R:' (RAMdisk) option for greater speeds.  Be sure to read any
  105. and all notes on the options before attempting to use any.
  106.  
  107.  
  108. Domain DataLink             Quick & Easy RBBS Setup                      Page 3
  109. ───────────────────────────────────────────────────────────────────────────────
  110.  
  111.     Make a directory for Domain DataLink somewhere on your hard drive.  If you
  112. are on a network, make sure the drive can be accessed by all BBS machines.  For
  113. this example, we will assume you have named the directory \DDL.
  114.     Copy all of the Domain DataLink files from the installation diskette into
  115. the DDL directory on your hard drive.
  116.     Create a batch file to run Domain DataLink.  Your batch file should appear
  117. similar to the following:
  118.  
  119. c:
  120. cd \ddl
  121. ddl P:F F:C:\RBBS #:%node% X:4
  122. c:
  123. cd \rbbs
  124.  
  125.     That's all there is to it!  Please note that this batch file assumes that
  126. you are using a FOSSIL driver.
  127.  
  128.  
  129. Domain DataLink           Quick & Easy Wildcat! Setup                    Page 4
  130. ───────────────────────────────────────────────────────────────────────────────
  131.  
  132.     Before we begin it will be assumed that you have a basic knowledge of the
  133. internal workings of Wildcat!; DOORx.RUN and DOORx.BAT files, Adding Dos hooks
  134. with Makemenu, adding doors with Makewild, Wildcat! enviroment variables. If
  135. you don't you may proceed with caution.  As the Unix gurus always say RTFM!
  136.     To set up DDL as a menu hook you must define it using Makemenu.  Give
  137. it a letter and assign it to one of your pre-existing menus.  If you are going
  138. to use it as a door, assign it in Makewild.  Make sure you set it as a multi-
  139. user door (after all what fun is it playing DOOM with yourself?).  Now on to
  140. the tricky part.  Create a directory somewhere (preferably on your BBS machine
  141. hard disk).  Unzip the DDL archive into it.  The following are examples of a
  142. DOORx.BAT and a DOORx.RUN, modify them as necessary to fit your system:
  143.  
  144. DOORx.BAT
  145. c:
  146. cd \wildcat\door\ddl
  147. ddl F:C:\WILDCAT\WCWORK\NODE%WCNODEID% X:3
  148.  
  149. DOORx.RUN
  150. c:
  151. cd \wildcat\door\ddl
  152. ddl F:C:\WILDCAT\WCWORK\NODEx X:3
  153.  
  154. These are both very generic setups.  If you are using non-standard com ports
  155. you will need to use other command line options:
  156.  
  157. ddl I:%WCIRQ% P:%WCPORT% F:C:\WILDCAT\WCWORK\NODE%WCNODEID% X:3
  158.  
  159. Domain DataLink          Quick & Easy Generic BBS Setup                  Page 5
  160. ───────────────────────────────────────────────────────────────────────────────
  161.  
  162.     Make a directory for Domain DataLink somewhere on your hard drive.  If you
  163. are on a network, make sure the drive can be accessed by all BBS machines.  For
  164. this example, we will assume you have named the directory \DDL.
  165.     Copy all of the Domain DataLink files from the installation diskette into
  166. the DDL directory on your hard drive.
  167.     Create a batch file to run Domain DataLink.  Your batch file should appear
  168. similar to the following:
  169.  
  170. c:
  171. cd \ddl
  172. ddl P:F X:3 F:C:\GBBS
  173. c:
  174. cd \gbbs
  175.  
  176.     Refer to the following page for complete information on the available
  177. command line options.  The above batchfile example assumes that you are using
  178. a DOOR.SYS type dropfile (X:3), a FOSSIL driver (P:F) and that the dropfile is
  179. located in your main BBS directory (F:C:\GBBS).
  180.     Now set up DataLink as a door on your BBS (refer to your BBS manual on
  181. installing doors or external programs if you are not familiar with this
  182. procedure) and you're all set.
  183.  
  184. Domain DataLink               Command Line Options                       Page 6
  185. ───────────────────────────────────────────────────────────────────────────────
  186.  
  187.  
  188.     ddl [name] B:[DTE] D:[DCE] I:[IRQ] P:[IO] T:[tleft] #:[#]
  189.                R:[rdisk] F:[path] X:[type]
  190.  
  191.     Most command line arguments are optional when using a BBS drop file (see
  192. information on the 'X:[type]' command line option).  Those arguments which are
  193. required to be used in combination with any drop file types are marked with a
  194. note.
  195.  
  196. IMPORTANT:  When using Synchronet with an XTRN.DAT drop file type, there are NO
  197.             command line options that need to be used!  The only optional
  198.             command that you may wish to use would be the 'R:[rdisk]'.  Read
  199.             any notes about the 'R:[rdisk]' option before attempting to use it!
  200.  
  201.     name    This is the users name or alias.  If the name or alias consists of
  202.             more than one word, this option should be surrounded by quotation
  203.             marks (e.g. "The User").
  204.  
  205.     DTE     This is the baud rate setting of the serial port.
  206.  
  207.     DCE     This is the actual connect (bit) rate of the modem.
  208.  
  209.             NOTE: While this setting is not required, it should be used if
  210.                   possible.  This is only needed on the command line when using
  211.                   CHAIN.TXT, DORINFO#.DEF, PCBOARD.SYS, and SFDOORS.DAT.
  212.  
  213.     IRQ     This is the IRQ line of the serial port.  This is only required
  214.             when using UART serial boards on non-standard ports (those other
  215.             than COM1 or COM2).  This is should be used for the channel or
  216.             port number when using Fossil, Int 14h (BIOS), or DigiBoard.
  217.  
  218.             NOTE: This option must be specified on the command line when
  219.                   using UART serial boards with non-standard port settings
  220.                   with the following drop file types: ALL except for XTRN.DAT.
  221.  
  222.     IO      This is the port number (when using a UART serial board on COM1 or
  223.             COM2), the I/O address of the port in hex (when using a UART serial
  224.             board on ports other than standard COM1 or COM2), or F for Fossil,
  225.             B for PC Bios, E for PS/2 Bios, or D for DigiBoard.  When using
  226.             F,B,E, or D for this option, a port (or channel) number must be
  227.             specified on the command line using the 'IRQ:' option if you are
  228.             not using a drop file.
  229.  
  230.             NOTE: When using PC BIOS, PS/2 BIOS, FOSSIL, or DigiBoard with
  231.                   ANY drop file type, you must specify this option on the
  232.                   command line.
  233.  
  234.     tleft   This is the amount of time the user has left online (in seconds).
  235.  
  236. Domain DataLink          Command Line Options Continued                  Page 7
  237. ───────────────────────────────────────────────────────────────────────────────
  238.  
  239.     #       This is the number of the node the user is connected to.
  240.  
  241.             NOTE: This number must be specified on the command line when using
  242.                   CHAIN.TXT or DORINFO#.DEF drop file types.
  243.  
  244.     rdisk   This is the full path to a RAMdisk.  This option is never required,
  245.             but will speed up the operation of Domain DataLink (while in the
  246.             link) if you have a RAMdisk available.
  247.  
  248.             IMPORTANT: This option should ONLY be used if you are running ALL
  249.                        of your BBS nodes on ONE machine.  If you are using
  250.                        multiple machines across a network, this option cannot
  251.                        be used.
  252.                        You must have a RAMdisk of sufficient size to accomodate
  253.                        the number of nodes on your system.  Domain DataLink
  254.                        requires 256k of disk space per node in the link.
  255.  
  256.             NOTE: This option can also be used to specify an alternate
  257.                   temporary directory.
  258.  
  259.     path    This is the path (excluding file name) to the BBS drop file.
  260.  
  261.     type    This is the type of BBS drop file to use.  1 = XTRN.DAT,
  262.             2 = CHAIN.TXT, 3 = DOOR.SYS, 4 = DORINFO#.DEF, 5 = SFDOORS.DAT,
  263.             6 = PCBOARD.SYS.
  264.  
  265. Domain DataLink               Questions & Answers                        Page 8
  266. ───────────────────────────────────────────────────────────────────────────────
  267.  
  268. Q:  Can Domain DataLink allow users to transfer files to each other even if
  269.     they are connected at different baud rates?
  270.  
  271. A:  Yes.  The DDLUSER.DOC (which can be read within the DataLink by users)
  272.     gives suggestions on types of transfer protocols to use with varying baud
  273.     rates.
  274.  
  275.  
  276. Q:  Can users play 4 player modem games through the DataLink?
  277.  
  278. A:  No.  Domain DataLink emulates a serial connection which will only allow the
  279.     connection of two users per session.
  280.  
  281.  
  282. Q:  Does this mean that only two users can use the DataLink at any given time?
  283.  
  284. A:  No.  Domain DataLink allows for an unlimited number of two player sessions
  285.     at once.
  286.  
  287.  
  288. Q:  In order for users to play modem games through the DataLink, do I need to
  289.     have the game they wish to play installed on my BBS machine?
  290.  
  291. A:  No.  The users should have the games installed on their machines, and be
  292.     familiar with the game operation prior to calling the BBS to link.
  293.  
  294.  
  295. Q:  Can I play modem games against a calling user?
  296.  
  297. A:  Yes.  But you will need to call into the BBS yourself in order to do so.
  298.  
  299.  
  300. Q:  What else can users do through the DataLink?
  301.  
  302. A:  Anything that can be done if a user calls another user directly can be done
  303.     through the DataLink and more.  The DataLink offers one important feature
  304.     that users can't do by calling each other directly - they can DataLink even
  305.     if they are connected to the BBS at different baud rates.
  306.  
  307. Domain DataLink               Problems & Solutions                       Page 9
  308. ───────────────────────────────────────────────────────────────────────────────
  309.  
  310. Q:  Domain DataLink links up fine and everything seems to work, but no data is
  311.     being transmitted.  I am using a network (ie: Lantastic, Netware Lite,
  312.     Personal Netware, Novell DOS, Netware, etc.).
  313.  
  314. A:  Most networks have their own version of SHARE built in.  In most instances
  315.     the built in SHARE doesn't work properly.  Loading the SHARE.EXE program
  316.     that is included with DOS in your AUTOEXEC.BAT file should solve the
  317.     problem.  If you are using a PEER-TO-PEER network, you should make sure you
  318.     are also using the DOS SHARE.EXE program on the SERVER machine.
  319.  
  320.  
  321. Q:  When two players go into the DataLink at the same time a DOS sharing
  322.     violation appears.
  323.  
  324. A:  In some installations this will occur.  The solution is to simply mark the
  325.     DDL.EXE file as READ ONLY by using the ATTRIB.EXE program that is included
  326.     with DOS.  Go into your DataLink directory and type: ATTRIB +R DDL.EXE and
  327.     press ENTER.  Your DDL.EXE file is now marked as READ ONLY and this problem
  328.     should no longer occur.
  329.  
  330. Domain DataLink                    Exit Codes                           Page 10
  331. ───────────────────────────────────────────────────────────────────────────────
  332.  
  333.     When Domain DataLink returns to the BBS it will return with one of the
  334. following error levels set:
  335.  
  336.     0   Successful.
  337.  
  338.     1   Failed operation.  This can occur for several reasons: insufficient
  339.         memory for buffers, unable to open files, unable to initialize com
  340.         routines, no BBS drop file specified, etc.
  341.  
  342.     2   Carrier was dropped.
  343.  
  344.     3   User ran out of time.
  345.  
  346. Domain DataLink                 Demo Limitations                        Page 11
  347. ───────────────────────────────────────────────────────────────────────────────
  348.  
  349.     To encourage product registration, the following limitations have been
  350. placed on the demonstration version of the Domain DataLink program:
  351.  
  352.     o   Users have a maximum time allowed in the DataLink of 10 minutes.
  353.  
  354.